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Scenario 
Setup Guide 


Content Recommendations à Recombee 


Content recommendations 


We are providing you with a detailed guide to the most commonly 
used scenarios for different parts of your website. Each scenario 
section includes an informative description and instructions on how it 
can be set up to get the most out of smart personalization with 
Recombee. 


The mentioned scenarios can be used for all sorts of content 
recommendations, e.g. videos, movies, articles, music, or podcasts. 


à Recombee 


Table of Contents 


How Recombee Works 
Data Input 
Scenario Setup 
Where to Use 


How to Start 


Scenario Set-up 
Homepage 
Top Picks For You 
Trending Now 
New Releases 
“Same Category/Genre Content” For You 
Movie/Article/Song Detail Page 
Related Movies/Articles/Songs 
Popular Content From the Same Genre 
Category/Genre Page 
Content of a Genre Listing 
Search 
Search Results 


à Recombee 


OÙ ob ei ol ei 
GOAN O1 O1 — ON O1 O1 OT O © CO © Ww 


N N 
CL, eh 


How Recombee Works 


Data Input 


Our advanced recommendation engine solution analyzes two main types of data: Attributes 
(product catalog information, user attributes) and Interactions (your user’s behavior and 
interaction history) producing real-time one-on-one recommendations applicable to each part of 
your customer journey. 


Scenario Setup 


The particular place across your customer journey where you show recommendations (e.g. 
recommendation box) is called Scenario. 


Recommendations Type, Recommendation Logic, and also optionally Business Rules (filters & 
boosters) are used to specify the behavior of the models for each Scenario. 


Where to Use 


Aligning personalization to your user experience road map, you can apply recommendations across 
an array of touchpoints. These include Homepage, Read Next/Watch Next, or Full-text Search. 


Fully set recommendations help your visitors find what they are looking for, saving time, increasing 
customer satisfaction, and decreasing churn, while improving your conversion rates (e.g. 
increasing the subscription base). 


How to Start 


1. Integrate your catalog and start sending us your live interactions using the guidance 
provided in our documentation. 
2. Choose which scenarios you want to utilize. For the fastest results, we recommend starting 
with one of the following basic scenarios: 
a. Movie/Article/Song Detail Page - Related Movies/Articles/Songs 
b. Homepage - Top Picks for You 
c. Full-Text Search Personalization 
3. Use this handbook or documentation for information on how to set up chosen scenarios. 


Enjoy your personalization journey! 
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Method of recommending 


Recommendation Logic _ / | 


Desired behavior of the models 


Where to Use 
the Recommendations 
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Live Interactions 


Interactions History 





K Interactions 


Fa 
| | 
d 


Scenario 


———-e A chosen point of user experience 


where recommendations are shown 


LA —~~ Business Rules (filters & boosters) 


Option to influence the final behavior 
of models using Recombee Query 
Language (ReQL) 


Home page 

Read Next, Watch Next 

Related Articles & Video-Galleries 
Full-text Search & Infinty Scroll 


Scenario Set-up 


Please note: All given scenario names are designed to better express their model 
behavior. The actual scenario names can be altered based on your preferences. 


Homepage 
Top Picks For You 


The “Top Picks For You” scenario recommends movies, articles, music, or other content that the 
user is most likely to be interested in. It is based on the user’s previous interactions on the site. 


For You 
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BORN TOOIE ) 
Meteora Born To Die Dont Smile At Me Random Access M... Shivers Days of Thunder 
Linkin Park Lana Del Rey Billie Eilish Daft Punk Van Buuren Armin The Midnight 
FOR YOU > 


FOLLOW A SPINNER’S WINTER ON THE MONGOLIAN STEPPE 


Spin Off 
(idee ac 


Visible Mending: 7 Tricks to Know Spin Off Subscription What Do Yarn Numbers Mean? 











Before You Sew Spin Off feeds our deep curiosity about the art and Weaving Yarns 

Patch it, mend it, or darn it—visible mending is hot! craft of making yarn. Each issue connects you to new Wonder what the numbers such as 5/3 or 2/20 mean 
Transforming a worn piece of clothing with vibrant and familiar voices in the handspinning community in weaving yarn? Amy Tyler has the answers. 

stitch work offers a great way to show off your and is packed with information about fibers, tools, and 

handspun yarn. traditions to inspire your creativity 








Top Picks for You 


Bicentennial Man The Watch Bill & Ted's Bogus Journey Opération Portugal 





Extra Tip: We recommend starting with this scenario when applying recommendations on the 
homepage. Having a high number of interactions would definitely help the performance. 
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Two-Step Set-up in Admin User Interface 


1. Create scenario: Name your recommendation scenario. You can name it like us “Top Picks 
For You” or choose your own label. Then select Items to User in the recommendation type. 


Create Scenario 


{Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 





Name 


Top Picks For You 


Scenario ID Top-Picks-For-You 


Recommendation type 


Items to Item 
Recommends set of items that are related to one given item. 


Items to User 


Based on user's past interactions (purchases, ratings, etc.), recommends top-N items that 
are most likely to be of high value for the given user. 





2. Set logic to define the behavior of the scenario: select recombee:personal Logic from the 
Universal Models. 


Universal Models personal + 


Universal Models E-commerce Classified Advertising 


Universal Recombee models for the most common use-cases. 


recombee:default @ 
recombee:homepage @ 
recombee:personal © 
recombee:popular @ 


recombee:recently-viewed € 
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Trending Now 


The “Trending Now” scenario recommends movies, articles, music, and other content that is 
recently globally popular amongst other visitors and highly interacted with. This scenario is used to 


promote currently popular content. 


Trending Now 


Peter Rabbit 2: The Runaway Raya en de Laatste Draak 


Popular news 


Jake Gyllenhaal is in talks with 
Michael Bay on ‘Ambulance’ 
Entertainment 


kJ 
Bundesliga 2020-21: Gameweek 
six in numbers 
Sports 


IPL: Kagiso Rabada's numbers 
against Mumbai Indians 
Sports 


IPL 2020, DC vs RR: Preview, 
Dream11 and stats 
Sports 





Spotlight 
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Faith Dynasty 


Buy Now ngl Buy Now 


Extra Tip: Other variants such as Trending In Your Country or Trending In A Genre can be also easily 


modeled. 
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Come Play 


Cosmic Sin 





Trending Topics 


Virat Kohli Liverpool FC 


2 Novak Djokovic Chris Gayle 


West Indies Cricket 7 
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Rod Wave x Kodak Bla... Rich Shit 


nal Buy Now ngl Buy Now 


Three-Step Set-up in Admin User Interface 


1. Create scenario: Name your recommendation scenario and select Items to User in the 
recommendation type. 


Create Scenario 


~ 


W Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 


Name 

Trending Now 
Scenario ID Trending-Now 
Recommendation type 


Items to Item 
Recommends set of items that are related to one given item 


Items to User 
Based on user's past interactions (purchases, ratings, etc.), recommends top-N items that 


are most likely to be of high value for the given user. 





2. Set logic to define the behavior of the scenario: select recombee:popular Logic from the 
Universal Models. 





Universal Models popular + 





Universal Models E-commerce Classified Advertising 


Universal Recombee models for the most common use-cases. 


recombee:default @ 
recombee:homepage @ 
recombee:personal @ 
recombee:popular © 


recombee:recently-viewed @ 


3. Set timePeriod parameter to two weeks (can be altered). That way, it would recommend 
popular content in the past two weeks. 


© timePeriod bd Default 1209600 (from Recombee default setup) 


The time period in seconds (from now to the past) in which the popularity is measured. For example, by providing 
value of 7280 , you will get the items most popular (and possibly trending) in last 2 hours, while when providing 
1209600 (thatis 14*24*3600 ), you will get items popular during much longer period of the last 14 days. 


1209600 
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New Releases 


The “New Releases” scenario recommends movies, articles, music, or other content that has been 
recently released and is a good fit for the user. 


New Releases 


ee 


n à 
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Hitman's Wife's Bodyguard Willy's Wonderland 





Ohio's Brewfontaine is Small-Town 
Bar with Big-Town Beer Selection 


From our Love Handles department for beer bars we love: In 
r Bellefontaine, Ohio, this small-town hub for local beer lovers 
nd similar a 3 J also attracts city folk who want to get out of town for a great pint. 





«th Find similar 


1M Find similar T A Recipe: Wolf & Workman Strong Ale 


This strong ale leans into British ingredients and London ale 
yeast for a robust but elegant brew that also serves ably as a 
winter warmer. 


Three-step set-up in our Admin User Interface 
1. Create scenario: Name your recommendation scenario. Request as Recommend Items to 


User recommendation in recommendation type. 


Create Scenario 


iZi Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 


Name 


New Releases 
Scenario ID New-Releases 
Recommendation type 


Items to Item 


Recommends set of items that are related to one given item 


Items to User 


Based on user's past interactions (purchases, ratings, etc.), recommends top-N item 


are most likely to be of high value for the given user 
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2. Set logic to define the behavior of the scenario: select recombee:personal Logic from the 
Universal Models. 


Universal Models personal + 


Universal Models E-commerce Classified Advertising 


Universal Recombee models for the most common use-cases. 


recombee:default @ 
recombee:homepage @ 
recombee:personal © 
recombee:popular @ 


recombee:recently-viewed @ 


3. Add booster coefficient to promote certain content: Click on “Add first Booster” and 
choose “Boost recent items” from the library. Setting up the boosting coefficient shows the 
desired content X times more likely than the non-boosted content. 


® Boostrecentitems © 


Prefer recent items 


Date property 
Property that specifies date of addition/release of an item 


release_date Lé 

Boosting coefficient 

Specifies how much the recent items should be boosted. Higher coefficient results in a greater boost of the item, 1 means no boost 
1 0.1 @ 10 

Number of days 


Prefer items added/released at most that number of days ago 


14 
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“Same Category/Genre Content” For You 


The “Same Category/Genre Content” scenario recommends content (movies, articles, music, etc.) 
from a category/genre that the user likes based on the user’s previous interactions on the site. 


Science Fiction Movies for You 


Space Soldiers Darkman 








| Sport Articles for You Rock Songs for You 
À =z a 
y 
IN ; 4 
Premier League, West Ham held; Leicester win Heroes Somewhere | Belong Fragile Tension 
big: Records broken David Bowie Linkin Park Depeche Mode 


NEVER : 





Bruins Ride Team Effort to Shutout Win in Nothing Else Matters Archetype Life On Mars 
Nashville Metallica Fear Factory David Bowie 


Three-Step Set-up in Admin User Interface 


1. Create scenario: Name your recommendation scenario. Select Items to User in the 
recommendation type. 


Create Scenario 


{Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 


Name 

Genre Content For You 
Scenario ID Genre-Content-For-You 
Recommendation type 


Items to Item 


Recommends set of items that are related to one given item 


Items to User 


interactions (purcha ings, etc.), recommends top-N items that 


of high value for the given user. 
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2. Set logic to define the behavior of the scenario: select recombee:personal Logic from the 


Universal Models. 
Create Scenario 


‘Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 


Name 


Genre Content For You 
Scenario ID Genre-Content-For-You 
Recommendation type 


Items to Item 
Recommends set of items that are related to one given item. 


Items to User 


Based on user's past interactions (purchases, ratings, etc.), recommends top-N items that 
are most likely to be of high value for the given user. 





3. Add a filter parameter to promote the same genre by clicking on “Add first Filter” and 
choosing “Items from the same category [set]” from the library. 


+ Global Settings Y 2Filters Xt Edit 


® Items from particular category [set] © 


Allow only items from particular category. The rule assumes that categories of items are a set property. 


Categories property 
Property that specifies categories of an item 


genres X 
Category name 
Allow only items from this category 


rock 
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Popular 


The “Popular” scenario recommends movies, articles, music, or other content that is long-term 
popular among the users and the particular user has not seen them yet. 


Popular 


Py. Ÿ d 


After We Collided The Mauritanian Zwaar Verliefd! 2 





Popular news 








Manchester United remain Shivers 
committed to Ole Gunnar Ed Sh 
Solskjaer, says Woodward cu 
Sports 
Ferrari reveals SF90 Spider plug- 
in-hybrid supercar with { rind On Me 
retractable hard-top oes 
Auto 
Kangana opens up about . 
undergoing physical i Money 
transformation for 'Thalaivi' msa 
Entertainment 
IPL 2020, All-round MI down 7 

7 RCB: List of records broken 4 Praise God > 
Sports Kanye West 


Three-Step Set-up in Admin User Interface 


1. Create scenario: Name your recommendation scenario and select Items to User in the 
recommendation type. 


Create Scenario 


iZ» Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 





Name 


Popular 


Scenario ID Popular 


Recommendation type 


Items to Item 


Recommends set of items that are related to one given item 


Items to User 


Based on user's past interactions (purchases, ratings, etc.), recommends top-N items that 


are most likely e of high value for the given user. 
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2. Set logic to define the behavior of the scenario: select recombee:popular Logic from the 
Universal Models. 


Universal Models popular + 


Universal Models E-commerce Classified Advertising 


Universal Recombee models for the most common use-cases. 


recombee:default @ 
recombee:homepage @ 
recombee:personal @ 
recombee:popular © 


recombee:recently-viewed @ 


3. Add timePeriod parameter to define the time relevance of the popularity of recommended 
content. 


O timePeriod © Default 1209600 (from Recombee default setup) 


The time period in seconds (from now to the past) in which the popularity is measured. For example, by providing 
value of 7290 , you will get the items most popular (and possibly trending) in last 2 hours, while when providing 
1209600 (thatis 14*24*3600 ), you will get items popular during much longer period of the last 14 days. 


31556926 


Extra Tip: We recommend setting the timePeriod parameter to one year. This shows the popular 
content from the given year. 
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Movie/Article/Song Detail Page 


Related Movies/Articles/Songs 


The “Related Movies/Articles/Songs” scenario uses a unique ensemble of models to recommend 
similar content to the currently viewed one based on the similarity in item properties (genre, actors, 


directors, publisher, artist, etc.). 


Related Movies 


Aquaman Robin Hood X-Men: Dark Phoenix 


Related Songs 





Days of Thunder Night Call Los Angeles Grew Up At Midnight 
The Midnight Kavinsky The Midnight The Maccabees 

. 
| Related Articles 
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Zlatan Ibrahimovic completes 300 goals (Europe's 
top five leagues) 


Novak Djokovic vs Rafael Nadal: Key stats 
(Australian Open) 


Tennis legends Novak Djokovic and Rafael Nadal are in AC Milan striker, Zlatan Ibrahimovic, on Monday, 


the entry list for the 2022 Australian Open completed 300 goals in Europe's top five football leagues 
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Godzilla Il: King of the Monsters 








Under Your Spell Hammer 


Desire Clif Martinez 





Decoding the five best Champions League 
matches in 2021 


The year 2021 is coming to an end and over the period we 
witnessed several top matches in the UEFA Champions 


League. 
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Two-Step Set-up in Admin User Interface 


1. Create scenario: Name your recommendation scenario and select Items to Item in the 
recommendation type. 


Create Scenario 


(=) Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 





Name 


Watch/Read Next 


Scenario ID Watch-Read-Next 


Recommendation type 


Items to Item 


Recommends set of items that are related to one given item. 





2. Set logic to define the behavior of the scenario: select recombee:similar Logic from the 
Universal Models. 


Universal Models similar + 


Universal Models E-commerce Classified Advertising 





Universal Recombee models for the most common use-cases. 


recombee:default @ 
recombee:similar @ 
recombee:popular @ 
recombee:visually-similar @ 


recombee:similar-properties @ 
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Popular Content From the Same Genre 


The “Popular Content From the Same Genre” scenario recommends globally popular content 
(movies, articles, music, etc.) from the genre of the currently viewed one. 


Action Movies for You 


ee 
PA 
us dé 

A > 


f 


Lockout Iron Sky The Darkest Hour Cosmic Sin 





Another Popular Sport Articles Another Popular Rock Songs 


Fragile Tension 








Depeche Mode > 
Heroes 
. > 
i 5 David Bowie 
Tennis: Presenting the best matches of 2021 
Y 4 
i AN 1 Life On Mars > 
David Bowie 
<< <A 
1BRAHIMO\E 
14 
Somewhere | Belong é 


Zlatan Ibrahimovic completes 300 goals (Europe's 
top five leagues) 


Linkin Park 





Three-Step Set-up in Admin User Interface 


1. Create scenario: Name your recommendation scenario and select Items to User in the 
recommendation type. 


Create Scenario 


(2) Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings 





Name 





Popular Content From the Same Genre] 





Scenario ID Popular-Content-From-the-Same-Genre 


Recommendation type 


Items to Item 


Recommends set of items that are related to one given item 





Items to User 
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2. Set logic to define the behavior of the scenario: select recombee:popular Logic from the 


Universal Models. 





Universal Models popular + 





Universal Models E-commerce Classified Advertising 


Universal Recombee models for the most common use-cases. 


recombee:default @ 
recombee:homepage @ 
recombee:personal @ 
recombee:popular © 


recombee:recently-viewed @ 


3. Add a filter parameter to promote the same genre by clicking on “Add first Filter” and 
choosing “Items from the same category [set]” from the library. 


® Items from particular category [set] © 


Allow only items from particular category. The rule assumes that categories of items are a set property. 


Categories property 
Property that specifies categories of an item 


genres X 


Category name 
Allow only items from this category 


action 


Extra Tip: You can also request the recently popular (trending) content from the same genre by 
setting timePeriod parameter of the recombee:popular Logic to e.g. one week. 


A Recombee 
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Category/Genre Page 


Content of a Genre Listing 


The “Content of a Genre Listing” scenario recommends movies, articles, music, or other content 
from a particular category or genre. The recommended content is suggested in a personalized 
order, so the best fits for the user are at the top. 


Action 


= j = e 
aN A 
John Wick 3 - Parabellum John Wick 2 The Avengers Godzilla vs. Kong 


Smooth 


Latest Smooth Beats 


BALLROOM 


‘à Find similar 
DopeBoyzMuzic 


DJPeter - Cog Lus Ntawm No 


‘à Find similar 
DJPeter Productions 


INVINCIBLE 
JIGGA BEATZ 


I Don't 


InsaneBeatz 


Chorderline - Altar (iann dior The ... 


Chorderline 


LOSING MY MIND 
JIGGA BEATZ 


= 
“a Find similar 


Browse All > 
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Three-Step Set-up in Admin User Interface 


1. Create scenario: Name your recommendation scenario and select Items to User in the 
recommendation type. 


Create Scenario 





¿Z Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 


Name 

Assets of a Genre Listing 
Scenario ID Assets-of-a-Genre-Listing 
Recommendation type 


Items to Item 
Recommends set of items that are related to one given item 


Items to User 


Based on user's past interactions (purchases, ratings, etc.), recommends top-N items that 
are most likely to be of high value for the given user. 





2. Set logic to define the behavior of the scenario: select recombee:personal Logic from the 
Universal Models. 





Universal Models personal -7 





Universal Models E-commerce Classified Advertising 


Universal Recombee models for the most common use-cases. 


recombee:default @ 
recombee:homepage @ 
recombee:personal © 
recombee:popular @ 


recombee:recently-viewed @ 


3. Set a filter parameter of the recommendation request to filter for a different genre on each 
page. This way you can send "documentaries" in ‘genres’ in the case of the Documentaries 
page and "drama" in ‘genres’ in the case of the page with dramas. 


Extra Tip: If the user scrolls down the page, the next best results are loaded by requesting 
RecommendNextltems (Infinite Scroll). 
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Search 


Search Results 


The search can be personalized, so besides the search query, also the user's interaction history on 
the site is taken into consideration in order to provide the best search matches. 


RECOMFLIX Browse Genres action| 


action 


In 


Rambo: Last Blood 


The Equalizer 2 Fast & Furious: Hobbs & Shaw Bad Boys for Life 





Search results for 
premier league 


News articles 





15 Dec 2021 14 Dec 2021 
Premier League, Zlatan Ibrahimovic 
Manchester City thrash completes 300 goals 
Leeds United 7-0: (Europe's top five 
Records broken leagues) 

Sports Sports 

12 Dec 2021 12 Dec 2021 


Raheem Sterling gets to 
100 Premier League 
goals: Key numbers 
Sports 


Premier League, West 
Ham held; Leicester 
win big: Records 
broken 

Sports 
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Two-Step Set-up in Admin User Interface 


1. Create scenario: Name your recommendation scenario and select Search in the 
recommendation type. 


Create Scenario 


(=) Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 





Name 
Search Results 
Scenario ID Search-Results 


Recommendation type 


Items to Item 
Recommends set of items that are related to one given item. 


Items to User 
Based on user's past interactions (purchases, ratings, etc.), recommends top-N items that 
are most likely to be of high value for the given user. 


Search 


Full-text personalized search. The results are based on a provided search query and also 
on the user's interactions. 





2. Set logic to define the behavior of the scenario: select search:personalized Logic from 
the Universal Models. 


Search personalized + 


Search 


Models for both personalized and non-personalized fulltext search. 


search:personalized © 


search:non-personalized @ 
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